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INTRODUCTION 


The B1i700 CANDE program provides generalized file preparation and 
updating capabilities itn an interactive, terminal - oriented 
environment. The Bi700 CANDE has been designed and implemented to 
conform in its functional behavior to the existing B6700 CANDE 
system. 


The B1700 CANDE is an MCS that runs in conjunction with the 81700 
NDL system. The NOL generated network controller performs all the 
data communication related functions» while CANDE performs’ file 
updating and text editing functions. CANDE can support a maximum of 
sixteen terminals and is tailored to make optimum use of the model 
33 teletype and the TD800 terminal’ss however» any terminal that has 
been qualified with NDL is capable of interfacing with CANDE. 


A basic usercode/password type of security is avatitable with the 
system. The user lLogsson with a usercode and password and may 
access any files that are ase CNseEG with his usercode. A recovery 
system is also provided. 


RELATED Ue peek aso 


NUMBER TITLE 
P.S. 2212 5223 : B1700 Network Definition Language 
P.eSe 2212 5215 - B1700 NOL/Library 
PeSe 2212 5412 B1700 Data Comm Audit 


1073715 B1700 NOL Reference Manual 
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SYNTAX SPECIFICATIONS 


SYNTAX DIAGRAMS 


The principle means of displaying CANDE command syntax is the syntax 
diagram. This method has been chosen because it affords a every 

concise and tucid exposition of syntax involving defaults» 

alternatives» and iterations; it is rigorous”) without being 

cumbersome. There are few format rules to remember: The basic rule 

is that any path traced along the forward directions of the arrows 

will produce a syntactically vatid command. The following examples 

illustrate the technique: 


~ 


<> » <=] 
! { . 
l-"“ROWT@ LM >THEW*>BOAT“@>GENTLY eet > DOWNES > = et eerste rres= >STREAM 


1-YOUR-! <<< =s === 1 P->THE I >OLD-- temo -MILLo> 1 
Valid productions of this diagram are? 


ROW THE BOAT DOWNSTREAM 

ROW» ROW» ROW» YOUR BOAT GENTLY DOWN THE STREAM 

ROW» ROW» ROWs ROW THE BOAT GENTLY DOWN THE OLD STREAM 
ROW YOUR BOAT DOWN THE. MILL STREAM 

ROW THE BOAT DOWN THE OLD MILL STREAM 
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The following convention is used to control the number of iterations: 


ACROSS THE cane te rece nn ne cena ce nnn ern nnn n ene enn en nnn n==> MISSOURI 


i <s-ss2=s5- 5 ae sneses M1 \------- 
i 
Jocceecece- >BIG serene eeennen- cnece- >I 
I 
Pomme nn WIDE ceetcecs er nncneenn- >I 


[omer nnn MUDDY cece ceceane- on---- >I 


The “bridge” over the "1" can be crossed only one time» so a maximum 
of one comma may appear. Valid productions are: 


ACROSS THE MISSOURI. 

ACROSS THE WIDE MISSOURI 

ACROSS THE BIG» MUDDY. MISSOURI 
ACROSS THE MUDDY» WIDE MISSOURI 
ACROSS THE BIG» BIG MISSOURI 
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An “«** associated with the number under the bridge indicates’ that 
the path must be crossed at least one timee If the previous example 
is changed to the following: = + 


; ! i 
ACRUSS TLHE SSF = hots css se ssen5 So PIG: Seeeeeeere eee sees 1 ess MIS S0UR I 


t ] 
pore anmanwnweamy WIDE seusme wasaewee aaa >1 
! j 
Jew ene een aan a> MUDDY aunanmana snaaouwama> | 


e 


Then proper syntax 15s obtained by crossing the bridge exactly one 
time. Valid productions are: 


ACROSS THE BIG» WIDE MISSOURI 
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SYNTAX CONVENTIONS 


CANDE commands are constructed of tetters>» digits» special 
characters» and blanks. Letters and digits are alphanumeric 
characterss alt other nonsblanks are delimiters. Alphanumeric 
characters may be separated into such items as integers» keywords 
and identifiers. Alt integers» keywords and identifiers must be 
entered in upper case characters. 


Keywords 


Uppercase letters in syntax diagrams indicates keywords which 
appear Literatly in the command. In many cases it is 
permissible to abbreviate the keyword by its initial or first 
few letters. In the syntax presentations underscores mark the 
Letters which must appears the rest are optional. 


Blanks 
Blanks in CANDE commands serve to separate syntactic items and 
may appear freely except within certain text fields» where they 
become significant characters. Blanks are optional on either 
side of a delimitere Whenever one alphanumeric item (Ckeyword>» 
identifiers» integer» etc.) follows another with no separating 
delimiter» they must be separated by at least one blank. 


End of statement 


End of statement is indicated by the fotlowing notation: 


oo me ew eee ewes ee ee ee meee ee were wens wee ewe e ene were anen> j 
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Syne ae -VARTABLES 


Lower-case tetters» words» and phrases in the syntax diagrams are 
syntactic variables» which represent information to be supplied by 
the user. A particular variable may represent a single character>» 
a simple construct such as an integer or text string» or a 
relatively complicated construct. Most variables are defined where 
used. Several variables and types of variables which are frequently 
encountered are defined here. 


Identifier 


An identifier is a string of characters used to represent some 
entity» such as a files or a usercode. Identifiers in CANDE may 
vary in tength from one to nine characters» and are composed of 
characters and digits only» with the first characters being a 
non™integer. 


Integer 


An integer is specified by a string of digits which represent 
the decimal value of the integer. Syntactic variables of this 
type occur frequently in CANDE. Some common examples are <s> 
Csequence number)» <col> Ccolumn number)» and <base> and <inc> 
(sequence base and increment). 


Oelimiters 


The delimiters may be any nonwalphanumeric character except one 
that occurs in the field being delimited or one that might have 
special - meaning in the context of its appearances these 
instances are detailed with each use of <delim>. (NOTES *.* 
CPERIOO) is not considered a delimiter). 
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Text fields 


A text field» denoted by <text> or <newtext>» is a sequence of 
characters to be sought or placed in ae fite. In most" text 
fields» all characters are significant and any character may 
appear except a specific delimiter. 


Sequence Range 


A <sequence range> specifies an inclusive range of sequence 
numbers which define a tine or tines to be tncluded Cor 
excluded) in a particular operation. 


Syntax? 


ae ns ana awe onaanaes anna amma we ae => <S?> an aw on ee oe a oe oe > 
{ I 


! 
[---> END ------- >I 
i 
! 


aseanantenr nr ates wmaeentana awe aera nmanaaae >| 


Semantics: 


The integers <Si> and <S2> represent sequence numbers. If both <S1> 
and <S2> appear» the sequence range inctudes both those vatues and 
atl values betweens <S2> must exceed <S1>. If <S1> appears atone» 
it defines a range comprising that single number. The keyword 
"END"» in place of <S2> represents the Largest sequence number’ in 
the file. 
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Column Range 


A column ranse specifies an inclusive range of columns» defining 
a portion of a line. 


‘Syntax: 


| awe wrmee a Se sans nose a naa won > | 


Semantics: 


The integers <col 1> and <col 2> represent positions ona Line. If 
both appears» <col 2> must exceed <col 1>»% and they define the group 
of columns including both and all between. If <col 1> appears 
alone» it defines a range comprising that single column. 


Logical Station Number 


The Logical station number <lsn> is an unique integer reference 
assigned by the DATACQMM system to each station in the DATACOMM 
network. This value is normally used when CANDE commands 
pertain to stations. , 


S21 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1i700 CANDE 


SANTA BARBARA PLANT P. S. 2212 5561 


OPERATING PROCEDURES 


Before a user can make use of the system capabilities» he must first 
present to the system his usercode and password. If th@ user is 
using a hardcopy device such as a teletype» the password may be 
typed Into an area that the teletype has blacked out. For screen 
devices» a similar degree of password security may be obtained by 
turning down the screen brightness before entering the password. 


CANDE checks the user's identification against the system's file of 
authorized users. If the usercode/password entered is not correct» 
the user is informed and asked to rerenter the information. If the 
usercode/password is corrects» CANDE responds with an appropriate 
message and considers the station to be a vatid user. The user 
cannot use the system until a successful log-in has occurred. 


Log-In 


The user may lLog~in to the system in any one of three ways. He may 
simply enter his usercode and password and thus get ltogged=-on. He 
may enter HELLO <usercode><password> and be lLoggedon or he may 
enter HELLO and the system will lead the user through the  Log-on 
sequence. 


3-2 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1700 CANDE 


SANTA BARBARA PLANT ‘Pe Se 2212 5561 


The logon sequence consists of the following steps: 


ae The system sends the following: 
ENTER USERCODE PLEASE. 


The user should respond by entering his usercodes either by 
itself or followed by a blank and his password. 


De If the user enters a usercode but not password, the system 
then responds with: 


ENTER PASSWORD PLEASE. 


For hardcopy terminal devices» the system then blocks out ten 
characters on the text Ltne into which the user should enter 
his password. . 


Ce If the system recognizes the usercode and password» it 
procedes to Step d. If it does not recognize the usercode and 
password it displays: 


SECURITY ERROR» ENTER USERCODE PLEASE. 


and the log-in procedure begins again. 


de On successful log-ins the system displays to the user. the 
following: 
STATION <togical station number> 
USER <usercode> LOGGED-IN at <time><date> 
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Ce If the user's previous session had been aborted dué to system 


failure or tine disconnetss» CANDE informs the user about his 
recovery file by displaying the following message: 


“RECOVERY DATA <workfile name> <date>* 
Wheres 


<workfile name> is the name of the recovered file. 
<date> is the date of the CANDE session recovered. 


Recovery of the indicated workfile is achieved by responding 
with the RECOVER command. 
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SNE Ns DATA 


Data and commands are entered in the form of messages from the 
keyboard of the terminal. 


Bae aiies CONTROL CHARACTERS 
The following special characters are supported by CANDE: 


FOR <7 USE 


end-of=message (ETX) controlt-C or carriage return 
backspace a left-arrow 
line delete | _. rubout or controle 


Data Identification 


If a message begins with one or more decimat digits it is 
assumed to be a data record and is added to the workfile; 
otherwise it is treated as a command. . 


CANDE Commands - 


The general group of commands to create and save files» to enter 
data and perform editing functionss are B6&700 CANDE compatible 
commands. These inputs are processed in seriat order» and are 
queued if they cannot be immediately executed. 
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Control Commands 


Control commands are a separate class of input messages preceded 
by the control commands character (?). These commands provide 
capability of controlling and interrogating the user's 
operating environment as explained in a later chapter. Notes 
however» that these commands are processed immediately and are 
not queued behind other commands from tha terminal. 


RESPONSES 


CANDE wilt respond to every command input by the user. ALl commands 
will: receive appropriate textual output as a response except for 
single-lLine entries» which receive only a "#" as acknowledgement. 
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FILES 


A file is a collection of records of information. It is the primary 
means by which the user establishes continuity between one CANDE 
session and the next or between CANDE and other programs. 


Filename 


A filename is used to identify a file in the B1700 system. when 
a fite is created through CANDE the user suppltes the file.id> 
an alphanumeric identifier of nine characters or less» and 
CANDE adds the usercode to form the complete filename; TeCe» 
<usercode>/<file.id>. 


The user may access any file under his usercode by simply 
‘specifying the <file.id> of the file. The user may access files 
belonging to another users» tn a read only modes To do this» the 


user must specify the <usercode>/<file.id> of the file being 
requested. Also» users may access files on user packs or user 
cartridges by specifying ON <packsid>-after the <file.w.id> or 


<usercode>/<file.wsid>. ; 


Syntax: 


wee ren n nnn e nn nn nnnn--=> filesid c---- wan------ #--------- ---->| 


i ! ! j 
I----> usercode/ ----] | I---> ON =~ pack.sid ==! 
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Type 


Possible types which may be specified for a workfile are: 
BASIC DATA MIL RPG SEQ 


COBOL FORTRAN NDL  ~— SOL UPL 


The BASIC» COBCLs» FORTRAN» MIL» NDL» SDL» and UPL types denote files 
for the respective compilers. A type SEQ is arbitrary data _ file 
with sequence numbers. A type DATA file is a file without sequence 
numbers. 


SEQUENCE NUMBERS 


Files which are edited by CANDE must contain sequence numbers. A 
sequence number is defined as a positive integer containing a 
maximum of eight digits which must appear in the input data record. 
The Length of the sequence number must be equal to or less than the 
sequence field width of that file. A sequence rnumber-i1s used to 
identify the Line for editing and to specify the position of the 
line in the file. Even if the Lines are input out of orders CANOE 
will arrange the lines in ascending order. Except for BASIC files» 
the sequence numbers are not considered to be a part of the data in 
the file. In BASIC the sequence numbers are also statement numbers 
and may be used in statements such as GO TO. Hencer resequencing 
BASIC files may cause programs to run differently. COBOL files are 
Limited to six digits and are found in the first six columns» BASIC 
files are five digits and are located in the first five columns. 
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RPG is also five digits and are Located in the first five columns», 
the rest (except type DATA=see DATA files) are eight digits and are 
found in cotumns seventysthree through eighty. If the user is in 
doubt» he should perform “RESEQ" command immediately after the 
"GET"® to insure that the file is property sequenced. Unsequenced 
files may be sequenced by CANDE. 


ERROR MESSAGES 


Error messages output by CANDE will be one or two lines in Length 
and will be setfrexplanatory. Unrecognized CANDE commands are noted 
as "NO SUCH VERB" errors. 


Files of type DATA are assumed to be eighty characters in tlength» 
with no sequence field. In order to edit files of type DATA» a 
RESEQ command should be performed immediately after toading the 
file. RESEQ will create “pseudo sequence numbers" tin cotumns 
eighty-three through ninety of the file. The file may then be 
edited in aonormat fashion. The SAVE command will remove’ the 
"nseudo sequence numbers™» restoring the file to its original 
unsequenced state. 
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WORKFILE 


CANDE can be directed to read any file the user has access to» but 
at any given time changes may only be made to one file which is the 
workfile. The user gets a new workfile by duing a MAKE» or he may 
recall an existing workfile by doing a GET. Additions and 
corrections may be performed on the workfile by single-lLine entries 
or by using the editing commands. 


A CANDE workfitle consists of tw6 parts. The "“tank™ (which is 
invisible to the user) is where additions and edited tines are 
placed until an update takes place. The “tank” contains a maximum 
of 32 entries and if an explicit update has not been issued by the 
time the “tank" is full» an automatic update 1s done» and the 
contents of the tank are merged with the workfile. An update 
incorporates alt additions and corrections of the workfile creating 
a new copy of the workfitle and a clean tank. An update does not 
make the users workfile a permanent file on disk. A SAVE is 
required to make the workfile a permanent file and to discard the 
original file. 
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RECQVERY 


Recovery of user's workfile occurs when CANDE is executed after. an 
abnormal termination. The recovery procedure involves detection of 
the presence of the recovery file and communications of this fact 
to the user. 


After tlog-~-in each user that was on the system when it aborted has 
the option of recovering his workfile. The user enters "RECOVER" if 
he wishes to get his previous workfile. If the user does not wish 
to recovers he merely starts another session. When a system goes 
downs it is possible to lose up to four records in the user's tank 
file. ; 
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COMMANDS 
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Control Commands: 


BREAK 5-2 
0S 5-6 
$5 5-46 
WHERE 5-60 
ZIP 5-61 
Editing Commands: 
DELETE 5-8 
FIX 5-18 
INSERT 5-24 
MERGE/RMERGE . 5-31 
MOVE 5255 
PAGE 5-35 
RESEQ 5°44 


SINGLE“LINE ENTRY 5-51 
Editing Mode Commands: 


MARGIN/@ 5°29 
SEQ 5749 


Environment Commands: 


BYE 373 
DCSTATUS 5-7 
FILES ae 14 
HELLO 5°23 
PASSWORD a= 37 
TEACH 5753 
TERMINAL 5=<55 
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Input“Output Commands: 


LIST 5-26 


Program Execution: 


COMPILE 574 
EXECUTE/RUN 5-12 


Search Commands? 


EDIT eas 
FIND 5716 
REPLACE 5“41 


Workfite Commands: 


GET aera | 
MAKE 5-28 
RECOVER 5~38 
REMOVE 5-39 
SAVE 5°47 
SPATCH 9°52 
TITLE 5756 
UPDATE 2°57 


WHAT 9-38 
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BREAK 


The BREAK command terminates the current output to the terminal. 


Syntax: 


PBRK ance enn nnn e ene --- woe ee nn nnn ene ------- a latetetetetatatetatetetatetl 
arenes <break key> 


Semantics: 


ALt output queued for the terminat is "“flushed™ when the BREAK 
command is processed. 
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BYE 


The BYE command terminates the user's current session. 


Syntax: 


Semantics: 


A CANDE session is terminated by the BYE command; switched lines may 
be disconnected. If the workfile has not been saved or removed» the 
user is notified of this condition. The workfile may then be 
removed or savede and the BYE command rewentered. 


Example: 


BYE 
USER <USERCODE> LOGGED“OFF AT <TIME & DATE> CTIME = <HH?MM:SS2:T>) 


NOTE: Time given is CANOE processor time. (See Appendix) 
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COMPILE 


The COMPILE command invokes the standard system compilers or any 
non-standard versione Options provide the ability to use an 
existing file or workfile»s to specify the object filenames to 
speci fy the compiler names and to specify the label equation and 
other control statements for both the compile and resultant object 
programs 


COMPILE -----+r----2- on rane n een n nen nne meen ewe nme cnenneeerece= >I 
- I S 4 ! 


| Kemer ee wart ateuecocan aeusanaae Te ee | i< ret es SY ae ee ee j 


j { i 
p-f) \-> source filename ,~-*7->] I->s-> modifier =->1 
5 A en ole 


j 

ALWA AP Ue, 
peda => AS Bhi CCE 4 Conaneseot 
1 s 10 €/~AR AC ETE ' 
jog Mes WITH compilername ==>) 


Semantics: 


If <source filename> is not specified» then the workfile wilt be 
used as the source file. If the object filename is not provided» 
then the source filename will be used. In either case» an "0" will 
be attached to the end of the file.id to flag the file an ‘object 
file. ; 


A compiler must be specified if the source filename given is not the 
current workfile. Also» a comniler should be given if the user's 
workfile is of a type DATA or SEQ. If no compiler is givens the UPL 
compiler will be the default. 
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Example: 

C 


Compile the workfile using the default compiler type and associate 
the object file with the workfile. 
COMPILE A/B AS D WITH SOL 


Compite the source file A/B as object file <usercode>/D with the SOL 
compiler. 
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DS 


The DS command OSes the users current running user program that was 
executed from CANDE. 


The DS capability implemented is timited in that it applies only to 
jobs fired-up by the EXECUTE or RUN from CANDE and opening a remote 
file to the terminal requesting the EXECUTE or RUN. If these are 
met» then CANDE obtains the mix number of that user program and the 
job may be DSed by entering "?05" from the terminal. 


Syntax: 


2DS--e-- leteckatatetatatebetatetatatatetatetatatebetetatebeteatae siatetatadetatatatetatatatetetatebatetetetatats 
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DCSTATUS 


The OCSTATUS command provides general information regarding the 
status of the user's station. 


- Syntax: 


DCSTATUS s--erer-- cocecen- allele alaatale tal aeeiatatatatatetatatatatatetatetatetatate > 


Semantics: 


DCSTATUS witl return to the user a lengthy run down of the user's 
station. The following 1s returned to the user: 


i. LSN 

2e NAME 

3- TERMINAL TYPE 

4&4. BUFFER SIZE 

Se MAX RETRY 

6. INPUT PRIORITY 
7. OUTPUT PRIORITY 
8. MESSAGE COUNT 
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DELETE 


The DELETE command discards records from the workfile. 
syntax: 


DELETES SSeS S222 SS ee SS > sequence range “*--> wee meee eween> 


] wwe wewecen ane ne ‘ ALL owen ae Ss a= =o == 4 


Semantics: 


Those Lines specified in the sequence range List are deleted from 
the workfile. If "ALL" is specified» the entire contents of the 
workfile is deleted» but the name and other attributes are 
preserved. 


Examples: 


DEL ALL 


Delete the entire contents of the workfile. 


DELETE: 100-500 


Delete Lines 100 through 500 from the workfile. 


DEL 200 END 


Deleta lines 200 through the end of the workfile. 
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EDIT 


The EDIT command displays a selected tine from the workfile, 
allowing the user to edit the tline.ew When Transmitting. back to 
CANOE» the Line will be returned to the workfile overlaying the 
original tine. Operation will continue with display of the next 
selected Line until the selection parameters have been satisfied. 


Syntax: 
EDIT ms Pe ee <<< ee Ss SS a Se eee ee eae Oe > eswenw 
-- I { I 

I="-> seq range ---->| I---> delim text delim =---- baad 
saaeenmy> ee ee ee Se aeaeew ss = nea ne = aunmaumoan ana w oo on a om a eam > | 

! 

nan ae> wae oo naan auannaanan ana ama nanan ewan am on Gh 58 On os an oF OS 8 a on oD on >| 

i 1 

[ <eet eon eae ee ee Se ee ee an ae we ena awe ae wm i] 

i a <column range> | 

t-S4\-> doa eee eee > 

t <count> i 

fe? tp ore ; tel a aU ane anne ewan anw aew wae >] 

t LITERAL J 

adh 4 Vacs eee i @838}8=« see a weaw we SSB Oates Dawa asanaaea ma >I 


Semantics: 


The next Line is selected from the workfile within a sequence range 
Cif given) or the entire file.~ The tine is scanned for the 
delimited text if necessary using the column ranger if givens as 
the start and stop points for the scan. If no column range is qiven 
then the entire line is scanned. If the text is found in the Line 
then the Line is displayed on the terminal and the counts if any» 
is decremented. 
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When the user transmits the tine back to CANDE» the sequence field 
is checked to be sure it is the same disptayed. If only the 
sequence number was transmitted then the original workfile is not 
overlayed. This allows the user to pass thru his workfite without 
overlaying each line unnecessarily. 


Termination occurs either when the selection parameters have been 
satisfied or a *"?BRK" command is returned. 


Selection Parameters: 


SEQUENCE RANGE ==" Only Lines with sequence numbers’ falling in 
this range Cincluding ends) will be examined. 


DELIMITED TEXT =*-= The tine is scanned for this text. If a column 
range is givens it must be large enough to 
contain the. given text. A certain degree of 


optimization can be obtained by specifying a 
column range that is exactly the size of the 
text. 


Q@COLUMN RANGE ="2= Text match its tooked .for only within this 
range. If onty one column 18S givens this is 
taken as the starting point for the scans the 
stopping point defaulting to the end of the 
record. 


COUNT ==<<-=se= --- This vatue specifies the number of lines with 
at least one occurrence of the text to be 
selected. 


LITERAL ect r"2"7"= Causes the scan to be performed in Literal mode 
rather than default token mode. 
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Examples: 


ENIT 30-70 /ABC/ 

Display those Lines between sequence 30 and .70 inclusive’ which 
contain the string "ABC". 

EDIT SABCD.XYZ/ 10 

Display up to 10 lines from the entire workfile (Cbeginning at the 
first line) which contain the string "ABCD.XYZ". 

EDIT S/XYZ23/ 353°57 

Display att tines which contain "XYZ23" in columns 53 through 57. 
Notice that this command will execute quicker than the first since 
the exact location for the scan has been given. 

EDIT /XYZ/ LITERAL 

Display all Lines containing "XYZ". Use the “LITERAL” ‘scan method. 


Note that this form of edit wilt find a match against the string 
*XYZA™ where the token form will not. 
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EXECUTE/RUN 


The EXECUTE and RUN commands cause execution of an object programs 
the RUN command will provide for compitation of the source file 
prior to execution if the object file is not available. 


Syntax: 
RUN@=- aeeacan a aS eSB ee enananaweanan asaane A awa wees st ena een suas naa = > 
- 4 | [<eeenenne--------- 
t. \berse-"> trlenare.<<---= { §-> 3 => modifier --I 
1 : | 
EXECUTE. “<== I-> $ ~-=->] 


Semantics: 


The workfile is assumed if no filename is provided. A "8" is 
specified only with EXECUTE» and refers to an object file not 
created by CANDE. 


A <filename> in EXECUTE may refer to any file to which the user is 
permitted access» but a <filename> in RUN must refer only to the 
user's current workfile. 


Modifier specifications may be provided. 
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Examples: 


EX 


Execute the object program associated with the workfile. 


RUN 3 FI LINE = REMOTES 


Execute or compilesand-go on the workfile name and label equate the 
output to the user's remote terminal. 
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FILES 


The FILES command provides a method for determining if a file is on 
disk. 


Syntax: 


FILESss2=> SSerssess merece eercnenee= filename scott scceen- Resse > 
1 ti 1 
I-~"=> OBJECT <"-=>1 1-> $ =I 


Semantics: 


The FILES command witl search disk for the specified filename and 
report whether or not the file is on disk. If the file is present» 
that fact is reported along with some general information about the 
file. The OBJECT parameter allows the user to search for object 
files created through the CANDE COMPILE or RUN commands. (i.e.» the 
file.id of the specified filename is changed to <file.wid> CAT "0). 
System object files or object files not created through CANDE may 
be found by using the normal filename syntax and omittina the 
OBJECT parameter. The “S" allows for inquiries on files not created 
-by CANDE. , 
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The following is returned to the users terminal when the specified 
file is found on disk: 


f 


FILE <filename> PRESENT 


USERS = <integer> (O-n) : 

TYPE = <file.type> CCODE» DATA» eee etc. ) 
SIZE = <integer> CEOF pointer of file) 
CREATED =: <date> Cmonth/day/year ) 
ACCESSED: 


<date> Cmonth/day/year) 
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FIND 


The FINO command searches a file for appearances of specific text. 
Output indicating the result of the search may be directed to the 
terminal. The output of a FIND is prompt driven» that is the 
command wilt fill a sceen to its page size and then the user must 
transmit a character to get the next page of output. 


aN crteratct 


[<-s ae ee eS ee Oe su eae aen aeons an anneananananananae ] 
io, wees filename seer teen eer =>] 
{ l---> type ---! 

ied g waes sequence range eetcrrrrrr= >| 
{ j 
od. Nos a column range s--------- >1 


Semantics: 


Onty one target may be sought with a FIND. The detimiters 
surrounding the target may be any delimiter. The text may contain 
any characters except the delimiter.j The text field may not be 
empty. The text field is treated as a token string unless LITERAL 
is specified. 
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The search is successful whenever the string of characters in the 
text field is found in a tine of the fite. 


If the integer <count> appears» the search for the associated text 
will be terminated after it has been found in the specified number 
of times in the file. 


If a <filename> is not specified then by default the workfile is 
searched. Specification of <filename> causes searching of the 
specified file» which may be any file the user is allowed to read. 
A <type> may be specified to give the Location of sequence numbers 
in relationship to the texts if no <type> is specified» a type of 
SEQ is assumed» if the user does not have a workfilesr otherwise the 
file type will default to that of the workfile. If a sequence range 
is specified only records fatling in that range are searched. A 
column range» if provided» indicates that only the specifted part 
of each record 1s to be examined. The option :TEXT if specified 
wilt output the entire Line cantaining the string to the user's 
terminals» otherwise only the sequence numbers of those records 
containing the string are output. The defaults for sequence range 
and column range are the entire file and the entire record 
respectively. 


Examples: 


FIND / FILEID / 100-900 


Search the workfile for the occurence of “FILEID™ within the lines 
100 through 900 and output any Lines found with the text to .-the 
terminal. 


FIND 10 / STUFF / 
Find the first ten occurences of “STUFF™ within the workfile and 


output the sequence number of the records containing the string to 
the terminal. 
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FIX 


The FIX command alters the contents of a line in the workfiles» by 
inserting new text or replacing part of the Lines. The alteration 
may be controlled by specifying target text» column numbers» or a 
combination. . 


Semantics: 


The integer <s> is the sequence number of the Line to be modified. 
If there is no such line in the file» the command is disregarded. 


The semantics vary for several forms of this commands depending upon 
the presence of column ‘numbers and text: . 


‘1. TEXT» NO COLUMNS: 


The specified line is scanned from teft to’ right for ae titeralt 
appearance of the character string specified as text. When Located» 
the target <text> is replaced by the character string specified as 
<newtext>. If the target is not founds the FIX is disregarded. Cnly 
one replacement is made on the tine. 
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2e TEXT» ONE COLUMN: 


The specified line is scanned as in 1.» beginning at col 1. 


3. TEXT» TWO COLUMNS? 


The specified line is scanned as in 1.» within the range cot 1 
through col 2. 


4. NO TEXT» NO COLUMNS: 


The newtext is inserted at the beginning of the Line. 


5e NO TEXT» ONE COLUMN: 


The newtext is inserted at the beginning of col li. 


6-2 NO TEXT» TWO COLUMNS: 


The characters in columns “col 1" through "col 2" are replaced by 
the newtext. , 


The <delim> which brackets the target text may be any. special 
character. The text may contain any characters except the 
delimiter. All characters» including blanks» are significant in the 
texts the text field is empty only if the two delimiters are in 
adjacent columns. The newtext field begins after the -second 
delimiter and runs to the end of the record. Blanks are 
significant} newtext is empty if the end of the record immediately 
follows the second delimiter. 


If the size of <newtext> is greater than the size of the string 
being replaced then the data in the record to the right of the 
string being replaced is shifted right -to make room for <newtext>. 
This may cause overflow. If the size of <newtext> is less than the 
string being replaced then the data to the right if the string is 
shifted left. 
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ra 


There 1% considerable function overlap between the FIX and REPLACE 
commands. FIX is specialized for single replacements on single 
Lines and has avery concise syntax.e REPLACE is more generals with 
file-searching and output capabilitys its various options require 
a more elaborate syntax. 


If a column number outside the text field is specified» or if col 1 
exceeds cot 2» the FIX command is rejected. 


Examples: 


FIX 398 1739 /AB/ABB 

Locate the target text "AB" within columns 1 through 39 of Line 398> 
and replace it with the newtext "ABB". 

FIX 500 /ENOS/END ELSE 


For Line 500» locate the text "END™S$ and replace it with “END ELSE™. 


FIX 10 40 //% ADJUST LINKAGE 


Insert newtext» % ADJUST LINKAGE» beginning in cotumn 40 of tine 10. 


FIX 2%41:*5 J/7 <end of statement> 


Delete the first five columns of Line 2+» shifting the image to the 
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GET 


The GET command recalls an existing file as the workfile. -If the 
unSAVEd workfile already exists» the GET command is in error. 


Syntax: 


GET Sawer ess) 11 Lenane: Sorters seer esses serene S seecs = Sots eRsen > 


- tf 4 i ot 
I-> * =I Jeoee-> type <s9-->t  fe-> : NOCHECK <-->! 


Semantics? 


The <filename> may specify any file to which the user has access. 
The <usercode>/<file.sid> option gives the user the ability to get 
a file that someone else created. The GET gives the user a copy of 
the file so that he will not alter the original file. The <type> 
specifies the file type of the file being loaded and will dictate 
where the sequence numbers are placed in relationship to the text. 
If <type> is omitted then the file is loaded as a SEQ file. If the 
file is one that was created by CANDE,s, the file wilt be properly 
sequenceds but if the file was not created by CANDE» the user 15 
responsible for sequence errorse If "*" is specified» only a_ file 
‘with that filename is sought and no usercode is appended. 
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If auser toads source files to system disk» and those files 


have 


only a single file~name» that user may now edit those files using 


CANDE. The user enters at his terminal GET 
*<MULTI“FILE=I0><FILE*TYPE> and CANDE will toad the fite (for 
editing. When the file saveds it will be saved under nat user's 
usercode as <USERCODE>/<NAME HE DID THE GET ON>. 
Sequence checking is automatic unless the NO CHECK option 15 
specified. 

Examples: 
GET AFILE 
Get an existing file named AFILE as the workfile. The type will be 
SEQ. : 
GET AFILE FORTRAN 
Get an existing file named AFILE as the workfile. The type is 
FORTRANs 
GET HIS/NEW UPL 

Load 


Get a copy of a file named NEW that belongs to usercode HIS and 
it as a UPL file. = 
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HELLO 


The HELLO command initiates a new user session without explicitly 
terminating the current session. 


Syntax: 


HELLO See ee pg eg ee ee ee aw nwaawaaa Cd ee ee ee ee aa > 
== \ ' , i 
Lse"*o USercode =Ses= S(eeeees PassvOrd. Ss ersr= 4 


Semantics: 


The current userts session is terminated by implicitly performing 
the BYE command and then invoking the normal Log-in process’ to 
initiate the new user's session. AS with the BYE commands this 
command is tn error if the current user's workfile has not been 
saved or removed. If the station is not currently loggedtin» then 
only the normat log-in procedure is invoked. 


Usercode and password may be included to complete the log-in 
procedure oor this information will be requested in the normal 
logrin manner. 
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INSERT 


The INSERT command copies records from the workfiles or from a file 
on disk» and places the copies into the workfile with new sequence 
numbers. 


Syntax: 
INSERT o>. 1 bename-=-="se3s-<se- SSeS SSS See ae Sa ea ==] <=> | 
= { 1 i £ a lf { t 


[essssee5 => I-> sequence range =>! I->AT=>base-----~ >I 
2 a= I t 
i-tinc| 


Semantics: 


INSERT copies records from any data file to which the user has 
access or from the workfile by default» and enters them in the 
workfile as a contiguous block. The entire file will be copied if 
a <filename> is specified and the sequence range List is omitted. 


New sequence numbers are determined by assigning an initial value to 
the first tine and incrementing that value for each succeeding 

line. An integer <base> specifies the initial value. The increment 

<inc> for successive sequence numbers in the block may be specified 

as anexplicit integer. If none appears» the default value of 100 

is used. 


The range of new sequence numbers may not overlap any lines already 
in the file» nor may the numbers exceed the largest sequence number 
which may be expressed in the sequence number field. 
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Examples: 


INSERT AT 30004100 

Insert the entire workfile into the workfile starting at 3000> in 
increments of 100. 

INSERT AFILE 1007600 AT 4000 


Insert the tines 100 through 600 from file AFILE into the workfile>» 
starting at 4000 and incrementing using the default of 100. 
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LIST 


The LIST command displays the contents of the workfile or some other 
file to the user at his terminal. Options are available for 
selecting specific tines and columns. 


Syntax: 
a a a laattatetaatetatate a a a a ic ce >I 
: el ci, I ae RO a EAE RE OSG AER NAIE ET, 
fod ese sequence Eas penne “=== ery: 
eee eee 4) sil aditoer Suse eeeaw eee 
neaeg Meeuess PAGED: 3S Sss52 SSscsccrS = eee: 


Semantics: 


By default» the contents of the workfile are Listed; if a <filename> 
is specified» it is Listed if the user has access privileges. A 
<type> may be specified so that sequence numbers can be located in 
relationship to the texts if no <type> is given» a type SE@ is 
assumed» if the user does not have a workfiles otherwise the file 
type is that of the workfile. 


A sequence range and a column range may be specifieds otherwise» the 
whole file and the entire Line are listed. 


Lines output to a terminal have the sequence number on the teft end 
of the record. 
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The option :PAGED will give the user one page» or screen of output 
starting at the second line of the screen. The user may then enter 
NEXT to get the next page or SAME to list the same page. The user 
may enter any valid workfile oriented command between pages. 


LIST :PAGED applies only for workfiles» that is a file the user has 
done GET or MAKE one and will not be tnvoked for a LIST of = an 
external file. 


Example: 

LIST :PAGED NEXT = SAME 
100A ~400D 4000 
200B 500E SOOE 


300C 600F 600F 
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MAKE 


The MAKE command creates a new workfile. If an unSAVEd workfile 
already exists» the MAKE command is in error. 


Syntax: 


MAKE son ee enter ene wn nnn nee > filesid ------ attatetatateteatate eeennen--> 


Semantics: 


The <file.~id> must define a new file within the user's library; it 
becomes the name associated with the workfile. A type SEQ file is 
assumed by default. The <usercode>/<file.w.id> option may not be used 
with the MAKE command. 


Examples: 


MAKE AFILE 


Make a new workfile with the name AFILE and a. default type SEQ. 


M AFILE U 


Make a new workfile with the name AFILE and a type of UPL. 
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MARGIN/Q 


ohn ae oe oe me we 


The MARGIN command controls the entry of text at the left margin of 
a line by inserting a specified number of blanks ahead of the data 
being entered. A margin specification may be in absolute column 
numbers:-or relative to the previous margins it may be effective for 
all subsequent lines entered at the terminal» or for a single Line. 
The "a" form must be used in automatic sequence mode. 


Syntax: 


MARGIN crecenecen enn enone lalallala tatetaiatetatetatetetatetatatetetetate once e------> 


ee ae | { — i ' y 


Semantics: 


If an unsigned integer <col> appears» the margin is set to that 
columns relative to column one at the beginning of the line. The 
value of <col> must fall within the text field of the Lines (Ce.g.» 
should not exceed 72 for UPL files). 


If a signed integer <col> appears» the margin is moved left (-) or 
right (+) by the number of columns specifieds the resulting value 
must fall within the text field of the Line. 


If no <col> appearss the margin is set to its default position at 
the first column of the text field. . 
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If the colon and <entry> are not entered» the new margin 


specification applies to atl subsequent entries from the terminal> 
until anew margin specification is entered or a GET» MAKE is 
performed. If a colon appears» the new margin Pe eLiecerEan applies 
only to the single-lLine entry which follows. 


* 


In automatic sequence mode» the "2" must be entered as the first 
character Cafter the system~supplied sequence number). If the colon 
and <entry> are not entereds the margin specification for 
subsequent entries is changed» and the sequence number is repeated 
for the next line. If a colton appearss the subsequent single-Lline 
entry is made at the sequence number provideds the user enters only 
the texts as in any other entry.in automatic sequence mode. Line 
overflow may occur as a result of: indentation. The user is notified 
at his terminal» and the resulting Line is.truncated. 


Examples: 


MAR 20: 4700 A:=B3 

Enter a line with A:=B beginning at column 20 with sequence number 
4700. ; 

MARGIN¢5 


Change the indentation position to the current starting position 
plus 5 columns and retain this indentation for allt following input. 
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MERGE/RMERGE 


The MERGE and RMERGE commands cause a specified file» or portions 
thereof» to be merged with the workfiles» with the result. becoming 
the new workfile. The two commands differ in precedence 
considerations when a record in the merge file has the same 
sequence number as a record in the workfile: MERGE keeps’ the 
workfile record and discards the others RMERGE does the reverse. 


Syntax: 


MERGE mam ee > filename a a ete ne a > sequence range aan mae ee ==>] 
RMERGE==<]f j-- newnmaws cSasnw wane wn oes nara awe | 


Semantics: 


The <filename> specifies any data file the user is allowed to read. 
If a sequence range appears» only the selected records are merged 
and the rest of the file is ‘ignored. The sequence numbers’ of 
records in the merge file remain unchanged as they enter the 
workfile. - 
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Examples: 


MERGE SYMBOL 

Merge the workfile with the complete file SYMBOL» keeping the 
workfile copy of records with identical Ci.ee. duplicate) sequence 
numbers. 


RM PATCHES 400-END 


Merge the lines 400 to the end of file PATCHES with the workfile»s 
discarding the workfile copy of duplicate sequence numbers. 
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MOVE 


The MOVE command moves lines from one point to another within the 
workfile» and changes their sequence numoers. 


Syntax: 


MOVE =""--"=> sequence range s=seee""> TO s-79495- > base “sss-e~* > 


Semantics: 


The Lines in the sequence range are deleted after being entered in 
the workfile as a continuous block. 


New sequence numbers are determined by assigning an initial value 
<base> to the first tine and incrementing that value for each 
succeeding Line. 


The increment <inc> for successive sequence numbers in the block may 
be specified as an explicit integer. If none appears» a default 
vatue of 100 is used. 


The range of new sequence numbers may not overtap any lines already 
in the file» nor may the number exceed the largest sequence number 
which may be expressed in the sequence number field. The 
destination may not overlap any existing records in the workfile. 
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Examples: 


MOVE 100-600 to 900+5 

Remove lines numbered 100 through 600 and reinsert them at 900» 905. 
910 e#oee “ 

MOVE 1000 to 6000. 


Remove Line 1000 and insert it at 6000. 
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PAGE 


The PAGE command displays futl screens of information at the 
terminal for editings and accepts full screens of input. from the 
terminal. Operations will continue until the command parameters 
have been satisfied or the user enters any command on the top Line 
of the terminal. 


Syntax: 
PAGE -<<<ss=s<=6 aa ee 00 Oa ee eS ae SS a SSS 2 eS “>i 
== i . ; . { 
Pi==> SEO RANGE ees 453425424 6=S=s—— aan aaeaiond => 
i , 1 
Eees> "AUTO" Sees ==S=s5eo= Se Le OS Oe a ra See a a ie ame >I 


| | 


Semantics: 


PAGE operates in two modes» a "LIST" mode and an “AUTO SEQUENCE 
MODE". Oefault operation is the “LIST™ mode in which the users 
workfile is displayed screen by screen for editing. The user is 
free to modify any or all of the screen» and can enter new Lines at 
any sequence number. (Note: Sequence number must be the same Length 
as those displayed). The "AUTO SEQUENCE" mode causes CANDE to 
generate a screen full of sequence numbers at the specified base 
and increment (default base and increment is 100° and 100 
respectively). If a record exists in the workfile at any sequence 
number generated» then that record ts displayed on the terminal and 
may be edited. 
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It should be noted that the screen input from a terminal is checked 
against what was previously output to the terminals» and only those 
records which were modified are added to the users workfile. In the 
"AUTO SEQUENCE" modes and additional check ts made on the sequence 
number fields and changes cause CANDE to output and «-.advisory 
message concerning the changes since these records can possibly 
overwrite existing records. It is permissible to transmit partial 
screenss in which case CANDE wilt roll up the remaining records and 
fill out the rest of the screen with new information. 


The PAGE command is terminated by satisfying the sequence’ range 
parameter in the “LIST* mode or exceeding the maximum attlowable 
sequence number for a given file type in the “AUTO SEQUENCE" mode,» 
or by transmitting any command from the top of the terminal. 


Example: 


PAGE 


Causes entire workfile to be listed for editing. 


PAGE 100-5000 

Causes existing records in workfile in the sequence range of 100 
through 5000 to be tisted for editing. 

PAGE AUTO 

Causes the generation of sequence numbers beginning at 100 and 
incremented by 100 to be displayed for editing Cany record which 
exists in aworkfile.at a generated sequence number wilt be 
displayed for editing). 

PAGE AUTO 10410 


Same as aboves except the sequence numbers generated begin at 10 and 
are incremented by 10. 
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PASSWORD 


The PASSWORD command allows the user to change his password. 


Syntax: 
PASSWORD="> current password ==> new password “-> new password-->! 
Semantics: 


To change passwords» a user must enter his current passwords the new 
passwords and for verification purposes» repeat the new password. 
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RECOVER 


The RECOVER command recalls a recovery fite as the workfile. After 
an abnormal terminates of CANDEs those users that were logged-on 
the system wilt have the option of recovering the workfile on at 
that time. 


RECOVER=se--=22n-=2- a ialatatatatatatetetatate weet eesresen- alataatahteettatatatetatetatet a 


Semantics: 


By entering RECOVER after loggingon» the user can_ recover his 
workfile. 


Example: 


REC 


Recover my previous workfile. 


5-39 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP Bi700 CANDE 
SANTA BARBARA PLANT Pe Se 2212 5561 
REMOVE 


The REMOVE command may be used to remove the workfile or any file 
with the user's usercode. 


Syntax: 


REMOVE see ere cnn enn eee een nnn n ewes ecenne ceecene- Satatatatatete ene----- >I 


os". 1 it it , y 
1 | 1 i-> $ 1 1 ~ | ! 
i | ey loess STS ~ Te ectd) Hs" Sse 4 >I 
tees> OBJECT. =sss>t * 


Semantics: 


The semantics vary with the form of the command. 


1. REMOVE 

The workfile is removed. No further editing can be performed until 
a GET or MAKE 1s performed. 

2. REMOVE <file.id> 


The user's source file <usercode>/<file.id> is removed. 


3. REMOVE OBJECT 


The user's object file <usercode>/<workfile nmame> CAT "0" is 
removed. 
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4. REMOVE OBJECT <file.id> 


a 


The user's object file <usercode>/<file.id> CAT "O" is removed. 


5e REMOVE OBJECT $ <file.wid> 


The user's object file <usercode>/<file.id> is removed. 


. Examples: 


REM 


Remove the workfile. 


REMOVE AFILE ON <pack.id> 


Removes <usercode>/AFILE form pack <pack.id>. 


REMOVE OBJECT AFILE 


Removes <usercode>/AFILEO if the file is of type "CODE". 


REMOVE OBJECT SAFILE 


Removes <usercode>/AFILE if the file is of type "CODE". 
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REPLACE 


The REPLACE command scans lLine-bysline through the workfitle or 
selected portions» replacing certain target text with new text. 
REPLACE is also’ a prompt driven commands» output comes to the 
terminal after transmission of any character from the _- home 
position.e ‘ 


Syntax: 


REPLACE ----- erenncnsn=>delimmron=>text—=-9>delimee--- >delim----> 


1 “> COUNT =fle-->COLUMN=">col i-=> = col 2-1 


1 4 . 
(i> First -1 | neceretece i 


' 
1 > LITERALI 
wmere=> newtext c= "> delim ----- Seka See Sesen ness ere arS s-=> 


t ] 
{ ( Seaces sequence range =*"":-~ { 
1 ! 
(i asl aan > 2 column range *"*7."-"" { 


V 1 i 
# 1 * a aS e SALA Sess Sees e er sa > 4 
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Semantics: 


Only one replacement may be specified in one REPLACE; the 
replacement is defined by a target and a substitution. The target 
specification may contain a text field or column numbers; the 
substitution specification always contains a newtext fields which 
can be blanks. The <teaxt> and <newtext> fields are bracketed by 
delimiters. The <text> or <newtext> may contain any characters 
except the delimiter. 


TARGET SPECIFICATIONS: 


The form <COLUMN col 1> causes the <newtext> to be inserted at the 
column specified. The form <COLUMN col 1 - col 2> means that the 
characters in columns col 1 through cot 2 are to be replaced by 
<newtext>. If <text> must be presents» and it specifies a target to 
be sought. 


For purposes of the search» all strings are considered to be token 
strings. Each line of the file is considered as an arbitrary string 
of tokenser excluding blanks. The search is successful whenever the 
string of characters in the text fields found in a tine of the 
file. Literal strings must be searched for in LITERAL mode. 


If the keyword FIRST appears» only the first appearance of the text 
on any tine is sought and replaced. If an integer <count> appears» 
the replacement will be terminated after the program has replaced 
<text> with <newtext> the specified <count> of times. 
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The replacement may be restricted at a sequence range of-the file or 
also to a column range of the record. The defaults are the’ entire 
record length and the entire file. 


If the option <:TEXT> is specified» the entire record is output to 
the user's terminal. If <:TEXT> is not specified» only the sequence 
numbers. of records: affected by REPLACE are output to the terminal. 


SUBST ET UESCh eee ee 


Whenever a target is founds the <newtext> (which may be blanks) 1S 
substituted. Adjustment for different length <text> and <newtext> 
is made by shifting the right-hand end of the line Cor column 
range) to the left or right» deleting or adding terminal blanks. A 
line overflow error is detected whenever the adjustment would shift 
non=blank characters off the end of the Line Cor column range). 


Examples: 


REP / AB / / ABB Ss 


Search the entire workfile for the string "AB™ and replace it with 
“ABB. 


REPLACE COL 4-5 / / 130-180 


Replace the contents of columns 1 through 5 in lines 130 through 180 
with empty newtext. 
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RESEQ 


The RESEQ command assigns new sequence numbers to lines.in_ the 
workfiles without changing the order of appearance of any Lines. 


Syntax: 


RESEQ s2ece---- a alatetatatatattatatate wae nn cnn nn mann sere neces enesecenne> | 


-- I 1 a 1 i 
P---> S = > S cme>l feseee> base crest Isee-> + inc s2*->1 
1 1 2 3 
I-> END =~! 


Semantics: 


An initial value is assigned as the sequence number of the first 
line to be re-numbereds the value is incremented for each 
subsequent tine. 


If a range of sequence numbers is provided» onty the specified part 
of the workfile is re-numbereds by default» the entire workfile is 
resnumbered. 


An initial value must be specified as the ‘integer <base>. The 
increment <inc> for successive new sequence numbers may be 
specifieds if none appears» the default value of 100 is assumed. 


RESEQ wilt not change the order of appearance of the tines. S1 must 
be tess than or equal to <base> and the <base> plus the number. of 
lines times the <inc> must not exceed S2 + <inc>. 
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Examples: 

RESEQ@ 200 

The entire workfile is re=numbered starting with the, initial | value 


of 200 and proceeding in increments of 100. 


RESEQ 100-700 100+10 


Reseq Lines 100 through 700 starting at 100 and incrementing by 10. 
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SS 


The SS command provides the ability to sent a message to another 
station or to the system SPO. 


syntax: 
199. Fa eor sees ore ss > Len rSees ere rR Shs e Ss) (Vext  SSeskedsseeeses> 
press es2 Ler > SF) seer eee =aae = >] 


Semantics: 


The receiving station may be referenced by <lsn> or by the 
<usercode> of a user if he is logged-on the system. The <text> may 
consist of any character string up to the maximum of the sending or 
receiving terminal's line Size. 
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SAVE 


The SAVE command causes the current workfile to be saved. 
Syntax: 


SAVE teem nero renee ceseeccenene alltel tahetetatataietatahe sataatetataatatatatatate 


-- i bio an) ' 
I=-> AS --> file.sid “<I l-->.0N <packeid>--t I-=>spatch --1 


Semantics: 


If no <files.id> is specified» the workfile is SAVEd under its 
workfile mame. The workfile may be SAVEd under a different name by 
using the "AS <file.id>" option. 


The :PATCH option attlows the user to create a “patch" file 
consisting of only those records of a source file which were 
changed during an editing sesston. Deleted records are saved in a 
patch file as "$VOID" records. 
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Example: 

SAVE 


The workfite is saved. 


SAVE AS AFILE 


The workfile is saved under the name AFILE. 
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SEQ 


The SEQ command invokes automatic sequence modes» causing the system 
to provide the sequence number for each new Linee With the 
exception of aC(MARGIN)» and ? Ccontrotl character)» no commands are 
recognized in automatic sequence mode. 


Syntax: 


SEQ mane a oe wwemeeane @SEe2eaeagqgcnun ames & Se eOagaiegeeswe Seta eew ese DH Beg ese @Beeseawes & as weeaawnouanaaowaw > 
. ( . { I 1 
prstesees> Fase. Ss en ere> | ae aa a ae ao » $4NG Tose =5 1 
! d- 
Sees e se © a ONE RL eae see = >| 


Semantics: 


An tnitial value is assigned as the sequence number of the next Line 
to be entereds the value is incremented for each subsequent Line. 

Initial values are specified by dn integer <base> and <inc> or by 

defaulting to values 100 for the <base> and 100 for the <inc>. If 

NEXT is specified» the sequence numbers pick-up from where the last 

sequence number for that user was terminated. 


Sequence mode is terminated by entering endtof-text immediately 
following the sequence number or by transmitting only the sequence 
number back. CANDE then displays a message at the terminal that 
automatic sequence mode is terminated. terminal that automatic 
sequence mode is terminated. 
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Normal CANDE commands are net recognized in sequence moder since 
they are indistinguishable form text’ entries. The 2 form of the 
MARGIN command is recognized if it is the first character in the 
input tLine. A Line may begin with 2 if it is entered twice as daa. 


If the line begins with the control character (?7)» the input 1s 
processed as a control command. 


Although the sequence number is generated by CANDEs» the tine 1s 
treated as a single-line entry: if the new sequence number matches 
one in the workfiles the older line is replaced. 


Example: 


S 10+10 


Enter automatic sequence mode using an initial and increment vatue 
of 10. . , 
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SINGLE*LINE ENTRY 


Any line beginning with a digit is a “command™ to enter anew tine 
of text at the sequence number specified» or to replace or delete 
the line already at the sequence number. 


Syntax: 


Oe ee een ewe w eee wena, Ss Een ane eeagw wea =e ee ae een nena oawcaaaas> | 


* { = oe we ueaewre newtext an aeoma onwoe | 


Semantics: 


The Line consists of an integer sequence number» <S>» =followed 
immediately by an optional newtext field supplying the contents of 
the new Line. The sequence number begins in the first column of the 
input Lines and runs until a nonedigit character is encountereds or 
until the maximum number of digits for a sequence number have been 
entereds newtext field begins in the column immediately followings. 
If there is already a tine if text at the specified sequence 
numbers» that line is replaced by the newtext or blanks. 


Examples: 


100 THIS IS A NEW LINE 


215 AND SO IS THIS 
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SPATCH 


The SPATCH command allows the user to insert up to ten characters of 
patch identification information into columns 81°90 of the workfile 
records for atl file types except "DATA". 


Syntax: 


SPATCH => detin “<“s> text “<=>. delin =< "<=535=<+-<-- Sse See > 4 
i . ! 
f---> sequence range *-~>I{ 


Semantics:. 


A delimited text string of up to 10 characters is required with the 
SPATCH command» and the sequence range is optional. If the sequence 
range is omitted» then the delimited string is saved as a permanent 
patch.id string and is applied to future entries to the workfile. 
If the sequence range is included» then the patchris string is 
treated as temporary and is immediately inserted into the workfi-le 
records specified by the sequence range. This latter form of the 
SPATCH command does not change any previous permanent setting of 
the patch.id. 
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TEACH 


The TEACH command provides the user with the capability of 
requesting an explanation of CANDE commands. _ 


Syntax: 


TEACH S28 Serer esses SSssee >< 5% SSeS SSeS Sse SSeS eS er eas SSS ee >1 
_ i “| 
Pene--> <COMMAND> oerr=>] 


Semantics: 


Entering TEACH without any specific command mentioned» will cause 
the system to return a complete List of valid CANDE .commands'9 and 
their valid abbreviations in form: 


<abbreviation> (<remaining letters>) 


@eges UPDATE will appear as: UPCDATE) 
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Entering TEACH <command> will cause the system to return three or 
more lines of text giving a full description of the semantics and 
syntax of the requested command. e.ge: TEACH UPDATE 

COMMAND: UPDATE 

SEMANTICS: CAUSES IMMEDIATE UPDATE ON THE WORKFILE 


SYNTAX: UP(OATE) =---- wee rrr nnn nnn nn nnn nnn n nn nnn ee =e >I 
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TERMINAL 


— 


The TERMINAL command will allow the user to specify the number. of 
Lines per page or screen for his terminal. 


syntax: 


TERMINAL --- See oe een 22 Rho, = 2s" e e=--> pagerlength = "72-27 =->/] 


Semantics: 


PAGE specifies the number of Mines per page or screens as the 
mniteger page-length. 
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TITLE 


The TITLE command changes the name of the workfile or a file on disk. 


Syntax: 
TIIFLE. ==*2"= ata Se eee > EE ENA 2. Sees Sees esas eee >| 
ons I 4 
Lesen=>. fj Lenane <1. S-s<-"1 


Semantics: 


If <filename> is not specified» the name of the workfile is changed 
for any subsequent SAVE command. 


The name of the file <filename 1> is changed to <filename 2>» which 
must be a new file name within the user's library. 


Examples 


TI ZAP 


Change the name of the workfile to ZAP. 


TITLE A TO B 


Change the file named A to B. 


5°57 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1700 CANDE 
SANTA BARBARA PLANT Pe Se 2212 5561 
UPDATE 


The UPDATE command forces immediate update action on the workfile. 
It is not necessary that the user explicitly invoke this. command; 
it is invoked automatically whenever the tank file in filled. 


Syntax: 


UPDATE =--2--- lalate lata tatatatatataatatatatatatetatatattentatatataatatatetatatatetet ae 


Semantics? 


UPDATE forces alt the changes/additions in the tank to be 
incorporated with the workfile. If the tank is empty» the UPDATE 
has no effect. 


BURROUGHS CORPGRATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


WHAT 


COMPANY 


P. 


The WHAT command indicates the state of the workfile. 


syntax: 


Semantics: 


The amount of information provided 


State of the workfile; 


is indicated. Output may 


ae 
b. 
Ce 
d. 
e. 
f. 


ge 


as much of the information as 
include: 


TITLE 

TYPE 

MARGIN settina 

SAVEd or unSAVEd status 
BEGIN SEQ NO: of file 
ENDING SEQ NO: of fite 

TIME = CANDE processor time 
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varies depending on the current 


is available 
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Example: 


WHAT 


TITLE: 
TYPES 
MARGIN SET AT 
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<filename>. 
<file type> 
<integer> 


WORKFILE IS SAVED/UNSAVED 


BEGIN SEQ NO: 


ENDING SEQ NO: 


<integer> 
<integer> 


TIME = <HH?MM:SS.1> 
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WHERE 


The WHERE command provides the <tsn> of a user. 
Syntax: 


PHHERE comet wewweseseeeeenn> Usercode sssettsssseses weceeene= >| 


aoe oy : { j 


Semantics: 


If the specified usercode is currently logged-in then his <lsn> 15s 
provided; otherwise the user is so notified. The ALL option = gives 
all users currently lLogged-on to CANDE. 
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ZIP 


The ZIP command provides for input to the MCP of certain MCP control 
strings through CANDE. Atl MCP control strings must start with a 
2-letter command selected from the following: 


AD» AF» ANs ATs» CAs CGs DS» DU» FI» FR» INe LOe MEs 
MO» MSs OV» RN» SW» TC» TH» UC» UF» UN» UVe VI 


Strings starting with any other text will be rejected by CANDE. 
If accepted by CANDE» the string will be ZIP-ped to the MCP. The MCP 


wilt report back to CANDE whether the string had any errors and 
CANDE wilt indicate that result to the user. 


The same mechanism is used to validate and handle control strings 


appended to COMPILE» EXECUTE and RUN commands. « 
Syntax: 
| Kom ewww nm emm ees n 5 Kem eee ennnen= i 
i . 1 
2ZIP sees eeeeern —Pameien= <UCP CONTROL STRINGS eres eel seen es eee >" 
Example: 


2ZIP LO FROM MYTAPE AFILE BFILE XY¥YZs MO X SWO = 13 
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OPERATORS INSTRUCTIONS 


This section is intended to provide the host system operdtor for 
CANDE with facts to help execute and maintain the CANDE system. 


Those topics discussed will be the execution of CANDE» the network 
controlter used and options available to the operator for 
maintenance of the CANDE system. 


The operator should have available for his use copies of 3 


BURROUGHS B1700 MESSAGE CONTROL SYSTEM INFORMATION MANUAL 
BURROUGHS 61700 NETWORK DEFINITION LANGUAGE INFORMATION MANUAL 
BURROUGHS B170Q SOFTWARE OPERATIONAL GUIDE 

BURROUGHS B1i700 CANDE INFORMATION MANUAL 


EXECUTION OF CANDE 


To use the CANDE system» the operator executes CANDE. CANDE will in 
turn execute the network controtler if it- is not currently 
executing. Both CANDE and the network controller should execute at 
a higher priority than other programs in the mix to insure adequate 
response times to the user. 


After CANDE is executed» it searches for a usercode/password table,» 
and if not founds the operator 1s requested to toad ae fite to 
system disk Labeled CANDE/RECOVERY containing the usercode/password 
table or to submit a card deck for creation of the table. If a card 
deck is submitted» the deck should consist of a maximum of 38 cards 
containing one usercode/password pair per card. The first ten 
columns of each card contain the Meereedes and the next ten wilt 
hold the associated password. 
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After this phase of initialization» CANDE will determine if recovery 
is appropriates and if so will build individual user recovery files 
for the previous CANDE session. - 


Finally» CANDE will execute the network controller if it is present 
on system disk» is not currently executing» and CANDE- program 
switch 0 is not = 1. If the network controtler cannot be found» the 
operator will be notified via the SPO. <Any desired network 
controller can then be executed. Note that by setting CANDE'S 
program switch 0 to l» a file named “CANDE/HANDLER™ can exist on 
system disk and CANDE will not attempt to ZIP-execute it. 


Files created or loaded by CANDE appear to the user to have but one 
nine character filename. To the CANDE program thoughs the files are 
named by the convention of usercode/filenames by doing this a small 
amount of file security is imposed on the systems and the hazard of 
two users creating files of the same name is eliminated. Users may 
have readtonly access to another user's files if he knows” that 
user's usercode. If one user. wishes to GET» MERGE» RMERGE» FIND» 
LIST or INSERT from another userts files the syntax of the command 
where filename is specifieds he may have usercode/filename» where 
usercode is the other user's usercode. 


SPO Options 


CANDE has the capability for communication from the terminal to the 
system SPO» and from system SPO to the terminal. Messages coming 
from the terminal will appear as: 


. USER = < lsn >3< textual message > 
The operator can talk to the terminal by entering: 


<mix # of CANDE> AX or Cusercode)<lsn of terminal to><message> 
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By the communication of terminal and system SPO» the user may 
request that the operator load files from mag tape» user cartridges 
or user pack to the system for access by CANDE. This requires that 
the operator be aware of what usercodes are running on the systems 
because files must be Loaded under the user's usercode. 


The system operator has certain commands that can be entered to 
CANDE. These commands are “WHO"™,» “STOP™» “ALL” and "MAKE". The 
"WHO" command will print a list of usercodes and associated logical 
station numbers that are currently logged-on the system. The 
command “STOP™ wilt brina CANDE to ae Logical conclusion. This 
command witt only be executed if there are no users logged=on the 
system. The “ALL” command allows the operator to broadcast a 
message to all terminals. The command “MAKE" is provided to allow 
the operator to make a station “READY™ or "NOT READY™. 


Syntax: 
MAKE <LSN> READY <INTEGER> 


Where <INTEGER> is "0" or “1i",. "0" makes the station not ready» "1" 
makes it ready. A station that 1s not ready will not be serviced by 
the network controller. See Appendix for further information. 
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CANDE/HANDLER 


BASIC: 


The interactive BASIC implemented for B1700 CANDE is like that seen 
on the B6700 CANDE. The user creates his file» then he = says 
COMPILE» RUN» or EXECUTE» and CANDE handles all file equations for 
the task. To make use of interactive BASIC» a naming convention 
must be followed in the NOL handler that is generated» the filename 
for the station must be "F"® CAT <station name> and this name -must 
not exceed four characters on COMPILES» RUNSse and EXECUTEs of BASIC 
files. ; 


SCROLLING: 


On TO820's only» users may now have the use of scrolling. Scrolling 
is enabled by entering a "?+S" and disabled by "?-S". In SCROLL 
mode» all entries are stilt made on:'the top lines but the entries 
are rotled to the bottom of the screen and the responses come back 
from the bottomeup. "?4+S" or "?"S" entered on TD800's will respond 
with “NOT A SCRCLLING DEVICE". To differentiate correctly the type 
of terminal» the following convention must be observed in the 
network controller running with CANDE: 


IN THE TERMINAL SECTION: 


TYPE = 14 (for teletypes) 
42 (for TO0800'ts) 
44 Cfor TD0820's) 
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Sequence Number Zero 


In both auto sequence and single-line entry modes a sequence number 


zero 1s now accepted» and will be the first record of that’ file. 
When auser gets a file with a record at sequence zero» a warning 
is issued that there is a sequence error at sequence number’ zero 


and the file is Loaded. 


Also implemented in CANDE requests and control is an output message 
control procedure which prevents output messages destined for a 
Station that is in local or otherwise unable to accept the message 
from being re~tried forever. After two tries» the output message is 
suspended until any one of the following occurs: 


1. 30 seconds elapse with no transmissions from the station. 


ACTIONS MESSAGE IS TRIED AGAIN AS ABOVE. 


2. User transmits something. 
ACTION: SUSPENDED OUTPUT MESSAGEC(S) RETRIED 
ALSO: INPUT IS SENT TO CANDE. 
3. User transmits "?". 


ACTION: SUSPENDED OUTPUT RE-TRIEO AND "2?" 
NOT SENT TO CANDE. : 
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This procedure prevents denied output, messages from taking over the 
processor. The network controller executed with CANDE should be 
compiled using "NOL/LIBRARY™ requests and controls selected from 
the following: . 


REQUESTS CONTROLS TERMINAL TYPE 
CANDEPOLTD | | POLSELCTL 1 T0800 
CANDESELTD I-------- reel AUTOPOLCTL ---"------ wac--- | T0820 
CANDEFSLTD | 

CANDEIOTTY cecetees"= CONVERCTL ceeeeteececee- TELETYPE 


Requests and controls to user in the NOL/LIBRARY as of 2-10-76. 


CANDEPOLTD “INPUT REQUEST 
CANDEFSLTO ee QUTPUT REQUEST (fast select) 
CANDESELTD - «ss QUTPUT REQUEST Cselect) 


CANDETDCTL LINE CONTROL 
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These requests include a number of functions specifically tailored 
to the output produced by CANDE in order to provide a more readable 
output at the terminal and to ensure recovery under’ terminal 
failure situations. See Appendix for further information. 


Other requests may be used with CANDEs however» results may be 
undesirable. 
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TERMINATION OF CANDE 


After CANDE has terminated whether from a logical conclusion or a 
system failure» the operator may dump to tape atl files associated 
with the CANDE system. A card deck which executes SYSTEM/LOAD.DUMP 
may be used. An example of such a seck follows: 


DUMP TO <tape.id> { 
CANDE/= { wcrc ee ooneestecoeweceseses= YNumps all internal 
| CANDE files. 


<usercode>/= 
ra 1 


These dump att files 
associated with the 

Sas anes = = a a ese “-- individual <usercode> 
and should include 
all usercodes in the 
user=code password 
table. 


<usercode>/= 
n 


After the dump is completes» that state of the CANDE system is 
preserved on tapes. Prior to the next session of CANDE»s the tape 
should be loaded back to system disk. This may be done by changing 
the "DUMP TO <tape.id>" card to a "LOAD FROM <tape.wid>”" card and 
executing the deck. 


ra 
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NETWORK CONTROLLER 


Compilation 


Following is a source Listing of a typical handler to be used with 
CANDE. ; 


File configuration allows user programs to open remote files to 
their own terminal without affecting operation at other terminals. 


For examples user “A™ at LSN=1 Cstation name = "ST1i"» available in 
file named "D1"%) may execute a program which opens a remote file 
named “D01". The program will then automatically be attached to the 
terminal from which the user executed the job through CANDE. 


Operation 


The requests specified itn Section "CANDE/HANDLER*® initially 
determine if the stations opened are onwLine and responding. Those 
that are not will be made not ready by CANDE. Switched lines will 
remain ina “waiting for ring™ state. If leased or direct terminal 
is inuse with CANDE and experiences failures» such as many 
consecutive timeouts or toss of data~setcready or loss of carriers» 
then the terminal is made not ready and recovery is initiated if 
appropriate. : 
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If a switched terminal is disconnected or the line is disconnected 
in any way» then the network controller wilt reinitiate a "wait for 
ring” state on the line and CANDE will recover alt appropriate data 
and will Leave the stations “ready” for the next dialsin. 


Reconnecting a direct or leased terminal wilt not automatically 
cause the network controller to recognize and service ite The 
operator must enter a “make” command at the SPO in order to make it 
ready. . 


Re-dialing from a switched station will cause immediate service when 
connected. 


After failure has occurred and the user has successfully 
re-connected» he must log on again at which time he will be advised 
of any recovery data he may have. 
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ALL RLU KL LEKI ILLIA MII IIA AI IG II IMI II AI IAI IAI AI AIA IAAI III AI IIIA AIM 


ah . . X% 
zz . DECLARATION SECTION 4% 
x% 4% 


yy Hy Si i Sy Se Sp Sey Ae Sip Sy Sy Sy Sy iy ey Sy Ay Ay Sy Se app My Aa Sy Ip Si Se iy Sp Li Se Sy Si ey aS i Se Se iy Sp Sa Sy Sp Say Sy ey Se Spy Ai Sy Aa Sy Bip Se Ly Si A MiB he 
x : 


rs 
DECLARATION: 

NIF="CANDE*/"NIF™.% 

MAX BUFFERS = 2.2% 

MAX MESSAGES = 10.% 
x . 
& 
RAMEE ZAARAL REALE hhh hh hhh hhhhhhhhihhhhhhahhhhhnhhhhhepparhnhnhh 
zz . am 
2 REQUESTS & CONTROLS y a4 
4% . 2% 


RARRAREARLEL ERA h ahhh hhh hhh hhh hhtehhhhhhheh hhh hhh hh hhhhhhhphhhhia 
$LIBRARY CANDEPOLTD % 

$LIBRARY CANDEFSLTD % 

SLIBRARY CANDEIGTTY 2% 

SLIBRARY AUTOGPOLCTL % 

$LIBRARY CONVERCTL % 


AAR KLARLAREEERALLN ERA hhh hhh hhh mh hhh h hhh rrhhhhhhhhhmhhhhhrhrhnhae 


2% . am 
x% NETWORK CONFIGURATION Z%. 
aA Z% 
MAL KL ELLE ELE L ELAR KKK hhh hhh hh hhahhhhhhhhhhkhhah hhh hhh hhhhhhhhhh hhh 
2% . ; 2z 
z% TERMINAL SECTION %% 
az az 


AREER LLL LALA EEEEL AEA KL ALLELE LAR hhhhhhhhhhhhhhahnhhhhhhhhhhhhahhhht 
TERMINAL DEFAULT TOFLT: 


REQUEST = CANDEPOLTD:RECEIVEs % 
CANDEFSLTOZTRANSMIT> % 

TRANSMISSION = 1. 

ADDRESS = Ze 

TYPE = 44.% 

BUFFERSIZE = 1020.% 
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TERMINAL TD824:% 


DEFAULT = TOFLT. 
TERMINAL TTY: © 

REQUEST = CANDEIOTTY:RECEIVEs x 
: CANDEIOTTY:TRANSMIT> 2 

TRANSMISSION = 0. 

ADDRESS = Ox: 

TYPE = 0. 

BUFFERSIZE. = 80.% 


BURROUGHS CORPORATION 


COMPUTER SYSTEMS GROUP 


SANTA BARBARA PLANT 


ALKRALEARERERE RELA RLL ALLL LL ALLL ELLA LEAL ZL ALE 


a 


STATION 


STATION 


z 


STATION 


STATION 


STATION 


STATION 


STATION 


STATION 


STATION 


STATION 


STATION 


DEFAULT TO8DF: 
FREQUENCY 
MYUSE 
TERMINAL 
RETRY 

DEFAULT TTYDF: 
FREQUENCY 
MYUSE 
TERMINAL 
RETRY 


ST1: % 
DEFAULT 
ADDRESS 

ST22 % 
DEFAULT 
ADDRESS 

ST3: 2% 
DEFAULT 
ADDRESS 

ST4:% 
DEFAULT 
ADDRESS 

ST5:% 
DEFAULT 
ADDRESS 

ST6:% 
DEFAULT 
ADORESS 

ST722% 
DEFAULT 
ADDRESS 

S$T11:% 
DEFAULT 
ADDRESS 

ST712:2% 
DEFAULT 
ADDRESS 


x 


hoi nm hs id Wf Won 


tou tt 


STATION SECTION 


Tia SEES SEs Tee Tee SEP CS eA GEE SEE ee ee ee ee eT eee eee Des ae eee ae ee eee 2 Gad ys 


Ce 246 

INPUT» OUTPUT. 
TD824. % 

4% 


Ce 24.% 
INPUT»OUTPUT.2% 
TTY.% 

oe 4 


TOSOF. % 
"Din, 


TD8DF. % 
"D2", 


TDO8DF. 2% 
sake BS Suk 


TO8DF .% 
"D4".% 


TOSBDF .% 
"R3"2% 


TOBDF.% 
"R4".% 


TO8SDF.% 
"RO"™.2 


TDOSDF .% 
TOSDF.% 


TTYDF.% 
"O00".% 


RARER A LRLAERAL ALA ALLALL LL LLG 
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XX 


x2 


z 
yA TD800 
yA . T0800 
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CREEL RL A LEAL A ELLA AL MALLU LALA ALAA LALA LKL ER KRALRKK ALKA MLA Ahhh hhh 


Zz x% 
Z% LINE SECTION X% 
2% £2 


pS iy ap Sr Ay Sy as Sep Sy iy Si Ai My iy Sy Ai Sp Spy ey ap Me yy Sey Sy Sip Ay Sy ay i Sy Ay Sa Sy iy Mi Sey Sy iy Sy Say Sy Sy Se ay ip Sin Sp Mi SiS Sy Sy yy Sy Ss ey AS Sy i 
LINE DEFAULT LINEDFLT: 


CONTROL = AUTOPOLCTL.Z% 
AUTOPOLL = 35. % 

v4 

LINE DIRECTOL: 
DEFAULT = LINEDFLT. 
ADDRESS = 41:20:26.2 
STATION = STLeSTerST3asST4eST5SeST6eST7. Z 

LINE SYNCO1:% 

DEFAULT = CLINEDFLT.% 
ADDRESS = 13022:.% 

STATION = ST11.% 

LINE TTYO1:% . 
DEFAULT = LINEDFLT.% 
CONTROL = CONVERCTL.Z 
ADDRESS =130:39.% 
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LRA EALRL ALLA L LAL LLL ALAA EAL AEA RURERAERLRRALALE RADA ZAR ZALLEALLK LAL EAALA LLL 


L2 | | 4X 
1% FILE SECTION LX 
%% %% 


MUSETEESTCATESESTE RELIES TEESE LERTE TEST ETETTTETETEETETETTETEREETETEEEETEE 
FILE CANDEQUEUE: Z 


FAMILY = ST1leST2eST3rSThoSTSeST6eST7oSTILsST12. % 
FILE Dl: 2% ° 
- FAMILY = S$T1.% 
FILE D2: % 
FAMILY = $172.% 
FILE O33: % 
FAMILY = $173.% 
FILE D4: % 
FAMILY = ST4.% 
FILE R32 % . 
FAMILY = ST5. % 
FILE R4: % 
FAMILY = ST6. % 
FILE R53 % 
FAMILY = $Tfa: % 
FILE S1: % 
. FAMILY = $1T11.% 
FILE TY: % 
FAMILY = $§T12.% 


RELA ALERERRULRARALELRAREELEAL LEE MERRRLELE RAL REEAUELLEELL EL ARAL KAA EaL RL AK 
FINI. 


7-8 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP B1i700 CANDE 


SANTA BARBARA PLANT P. Se 2212 5561 


Terminal Options 


CANDE has been designed to perform optimally to Burrough's 1T10800o0r 
T0820 series and Teletype series terminals. The requests specified 
under “Operator Instructions” are desiaqned to handle these two 
types of terminals. 


Other terminals to be connected to the CANDE system may not operate 
correctly with these requests» although any Burroughs! qualified 
terminal for the B1700 can be connected to the CANDE system via a 
user coded request which could include the special features built 
into the released CANDE requests.: 


CANDE makes uses of certain control codes to effect a more readable 
output. Terminals should be so optioned when setup: 


a0DQ CCR)» © a259 (LF), a0Cd COC4)» 
a3CaQ CHOME ONLY)» diila (OC1)>» ai3a (D0C3) 


Teletypes need only have CR» LFs 1TD800-820 series must have alt but 
LF. 


CANDE also relys upon “TERMINALTYPE” as set in the NDL-generated 
network controller. The expected values are: 


0 
any value not 0O 


Teletypes 
T0800-820 


if 


Output is unpredictable if this convention is not observed. 
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CANDE Processor Time 


A value catled "“TIME™ appears on the screen whenever WHAT» BYE» or 
"HELLO”™ is transmitted. This value is the amount of time the user 
spent being serviced by the CANDE system. This time will be less 
than the difference of tlog-on and tlog-off times except after 
recovery when the previous session's time 1s taken as a starting 
time. 


The time value is not strictly hardware "CPU" time. It includes I0 
time for both datacomm and any disk accesses. Included also are 
such system overhead costs aSs overlay» service requests» 
roltin/rollout of the users» and others. 


It is not intended to be used directty for billings but is an 
indication of the amount of time the CANDE system spent in 
servicing the user. 
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APPENDICES 


ALPHABETIC INDEX: 


APPENDICES 

BREAK 

BYE 

CANDE 
CANDE MECHANISMS 
CANDE/HANOLER 
COMMANDS 

COMPILE 

DATA FILES 
-DCSTATUS 


EDIT 

ENTERING DATA 
ERROR MESSAGES 
EXECUTE/RUN 
EXECUTION OF CANDE 
FILENAMES 

FILES 


INSERT 

INTRODUCTION 

LIST 

MAKE 

MARGIN/Q@ 

MERGE/RMERGE 

MOVE 

NETWORK CONTROLLER 
OPERATING PROCEDURES 
OPERATORS INSTRUCTIONS 
PAGE 

PASSWORD 

RECOVER 

RECOVERY : 
RELATED DOCUMENTATION 
REMOVE 

REPLACE 

RESEQ 

RESPONSES 

SAVE 

SEQ . 

SEQUENCE NUMBERS 
SINGLETLINE ENTRY 
SPATCH 

SPECIAL CONTROL CHARACTERS 
3S 

SUBSTITUTION SPECIFICATIONS: 
SYNTACTIC VARIABLES 
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WORKFILE 
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